home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / printer-studio / pana24pin / readme-24-pin < prev    next >
Encoding:
Text File  |  1995-01-01  |  77.9 KB  |  1,877 lines

  1.                             COPYRIGHT 
  2.                             =========
  3.  
  4. THIS PROGRAM  COPYRIGHT  1993  BY  WOLF  FAUST.   ALL  RIGHTS
  5. RESERVED.   THIS  PRODUCT  (PANAPLUS) IS SUBJECT TO PROPRIETY
  6. RIGHTS.
  7.  
  8.                             DISCLAIMER 
  9.                             ==========
  10.  
  11. THE  DRIVER  HAS  BEEN  PROVIDED  TO YOU STRICTLY 'AS IS', WITHOUT
  12. WARRANTY  OF  ANY  KIND.   IN NO EVENT SHALL PANASONIC OR FAUST BE
  13. HELD  LIABLE  FOR  ANY  LOSS OR DAMAGES ARISING OUT OF ANY ACTION,
  14. FROM  WHATEVER  SOURCE, CONCERNING THE USE OR INABILITY TO USE THE
  15. DRIVER.   SAVE  IN  RESPECT  OF DEATH OR INJURY ARISING OUT OF THE
  16. NEGLIGENCE OF PANASONIC OR FAUST.
  17.  
  18.                             Trademarks 
  19.                             ==========
  20.  
  21. Amiga is a registered trademark of Commodore-Amiga, Inc.;
  22.  
  23. All  other  trademarked products and company names used herein are
  24. used   for  identification  purposes  only.   No  infringement  of
  25. trademarks  is  intended.   Trademarks  remain the property of the
  26. trademark holder.
  27.  
  28.                  Welcome to the PanaPlus Driver
  29.                  ==============================
  30.  
  31. The  PanaPlus  driver  is a software for controlling printers
  32. with  the  Commodore-Amiga  personal  computer with the purpose of
  33. creating  high  quality  output.   PanaPlus's  main qualities
  34. include:
  35.  
  36. o  Freely definable dither routines (many are included).
  37.  
  38. o  16-point colour adjustment for each colour component.  This allows
  39.    you to do gamma correction, adjust the contrast and brightness,
  40.    plus more.
  41.  
  42. o  Ink compensation for the correction of ink impurities.
  43.  
  44. o  Workbench 2/3 graphical user interface (GUI).
  45.  
  46. o  The driver can print up to 256 shades of grey from normal
  47.    Amiga applications.  Standard Amiga drivers are limited to 16.
  48.  
  49. o  Full control over page size, paper margins and size of the printed
  50.    graphics.
  51.  
  52. o  Full control over built-in printer typefaces.
  53.  
  54. o  The software is very fast and automatically uses improved routines
  55.    if the software is run on an Amiga with a 68020/30/40 CPU.
  56.  
  57. o  Builtin support for the arXon electronic centronic switch box.
  58.  
  59. o  Free definable tab stops.
  60.  
  61. o  Job end signal.
  62.  
  63. o  Supports Workbench 1.3, 2.0, 2.1 and 3.0.
  64.  
  65. o  Prints up to 256 greyshades instead of 16.
  66.  
  67. These are not the complete capabilities of PanaPlus, merely
  68. some highlights.
  69.  
  70.                        System Requirements 
  71.                        ===================
  72.  
  73. PanaPlus  is compatible with the entire family of Amiga computers.
  74. These  include  the  A500,  A1000,  A1200,  A1500,  A2000,  A2500,
  75. A2500/30,  A3000  and  A4000.   PanaPlus was designed to run under
  76. Workbench versions 2, 2.1 and 3.  The PanaPlus printer driver also
  77. work  under Workbench 1.3, but must be controlled via the keyboard
  78. (CLI)  because  all PanaPlus programs with that have a GUI require
  79. at least Workbench 2.
  80.  
  81.                      Installing PanaPlus 
  82.                      ===================
  83.  
  84. The  PanaPlus  driver  is  a  replacement  for  the Commodore
  85. supplied  printer  drivers.   It is a 100 percent Amiga compatible
  86. printer  driver,  except that it offers many more functions than a
  87. normal printer driver.  The additional functions of the driver are
  88. controlled by a preferences program included with PanaPlus.
  89.  
  90. The  programs and driver are described in detail later.  Start the
  91. installation  by  a simple double click on the Install icon, found
  92. in the main drawer of the PanaPlus disk.
  93.  
  94. You   should   follow  the  checklist  below  for  installing  the
  95. PanaPlus software:
  96.  
  97. o  The driver was designed for the Panasonic KX-P2xxx series of
  98.    QuietPrinters. Older Panasonic printers may not work properly
  99.    with this driver!
  100.  
  101. o  Set  up  and connect your printer as described in the printer's
  102.    user  manual  and Amiga system manual. 
  103.  
  104. o  Ensure your printer's Initial Setup is configured to Epson
  105.    emulation and USA character set. KX-P2023 users should use
  106.    the provided "KX-P2023-Setup" program.
  107.  
  108. o  Boot your Amiga with your usual system or Workbench disk.
  109.  
  110. o  Double click on the  Install  icon found in the driver drawer of
  111.    the PanaPlus disk. The install program will copy the driver to
  112.    your system disk. In order to do so, you need 30 KByte empty
  113.    disk space on your system disk.
  114.    
  115. !  Most likely floppy users must make space on their system disk in
  116.    order to install the driver. This can be done by deleting unneeded
  117.    programs using the Workbenchs 3.0 "Delete..." menu item.
  118.    
  119.    Here is list of programs that might be deleted:
  120.  
  121.    Sys:Utilities/Clock        (13 KByte)
  122.    Sys:devs/printers/generic  (1.5 KByte)
  123.    Sys:system/nofastmem       (1 KByte)
  124.    Sys:c/Edit                 (15 KByte)
  125.    Sys:c/Diskchange           (0.5 KByte)
  126.    Sys:c/Lock                 (0.5 KByte)
  127.    Sys:c/Search               (1.5 KByte)
  128.    Sys:c/MagTape              (1.5 KByte)
  129.  
  130. o  Start  Preferences  on  your system disk (if you own Kickstart 2.0
  131.    use  the  "printer"  preference program).  Select the PanaPlus
  132.    driver   and  adjust  all  other  preference  parameters  to  your
  133.    environment.   See  your  system manual for more information about
  134.    the preference program.
  135.  
  136.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  137.    !Make sure "Ordered" dither and density > 2 is set in Preferences!
  138.    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  139.  
  140. o  In case you use Workbench 2.0 (or higher) use the mouse to drag
  141.    the Settings and PanaPref icon into your Workbench prefs
  142.    drawer.  If your Workbench disk does not allow this because no
  143.    space is left on disk, you can simply drag the programs to any
  144.    other wanted drawer.
  145.  
  146. o  Start the PanaPref program wich is located on the PanaDisk.  You
  147.    need Workbench 2.0 (or higher) for using PanaPref.  Adjust all
  148.    parameters to your wanted environment.
  149.  
  150. o  If your system disk is a hard disk, you may drag the PanaPref,
  151.    "Color-Settings" and "Dither-Settings" icons into your systems
  152.    "Prefs" draw for later use.
  153.  
  154.    Floppy users can keep the PanaPref program on the PanaDisk and
  155.    start it from there.
  156.  
  157.  
  158. After successfully running the Install program, try printing from
  159. the application with which you normally print.
  160.  
  161.  
  162.                    The Workbench Printer Drivers
  163.                    =============================
  164.  
  165. After  installing  a  PanaPlus  driver you should be able to print
  166. from  your  normal  application  programs.  In most cases you must
  167. further adjust the driver settings to your printer to get the best
  168. printer  output possible.  Correct adjustments often lead to major
  169. quality   improvements.    This  chapter  describes  most  of  the
  170. functions  for  controlling  the  Panasonic  driver.   But  before
  171. describing  the  driver  in  its own special section, some general
  172. things about printer drivers, and especially the PanaPlus driver.
  173.  
  174. Printer  drivers  offer a way of sending configuration-independent
  175. output  to  a  printer  attached  to  the  Amiga.  A driver can be
  176. thought  of as a filter that takes standard commands as input, and
  177. translates  them  into  commands  understood by specific printers.
  178. The  commands  sent  to  the  printer  via  the  prt:   device are
  179. standardized  on all Amigas so that programmers only have to write
  180. the software once and not for all possible printer emulations.  It
  181. is  the  task  of the printer driver to translate an Amiga printer
  182. command  into  the  correct command for a particular printer.  For
  183. each  type  of printer in use, a printer driver (or a driver for a
  184. compatible  printer)  should  be  present  in  the "devs:printers"
  185. directory.
  186.  
  187. If  you  want to print text in bold, you have to decide whether to
  188. use  a  standard  Amiga command (also known as an escape sequence)
  189. via  prt:,  or  the  command  mentioned in your printer manual via
  190. par:.   Often  people  get  confused about prt:  and par:.  Do not
  191. send commands mentioned in your printer manual to prt:.  This will
  192. most  likely  fail,  or  cause  wrong  characters  in your printer
  193. output.   You should always prefer prt:  to par:  because commands
  194. send  to  prt:  can be used on every printer, not just the kind of
  195. printer  you  have.   The  par:  device has even more shortcomings
  196. than prt:, but we're not concerned with them in this manual.
  197.  
  198. An  often  used  argument  from  programmers  using  par:   is the
  199. unlimited  control  over the printer.  This is a fallacy.  You can
  200. control every printer feature via the prt:  device.
  201.  
  202.                    The PanaPlus Printer Driver
  203.                    ---------------------------
  204.  
  205. The  PanaPlus  printer  driver  automatically  check  for the
  206. processor  being  used  (68000,  68010/68020,  68030,  68040)  and
  207. optimize the print routines accordingly, so there is no need for a
  208. special `turbo' version of the driver in order to get the most out
  209. of your Amiga.
  210.  
  211. The  tables  below  show  the  graphics densities supported by the
  212. PanaPlus  driver.   Density  is set in Workbench preferences.
  213. Often  you  can also choose a density from within your application
  214. program.    Beside   the   density   tables,   a  table  with  all
  215. driver-supported  Amiga  escape sequences (use prt:  not par:  for
  216. these commands) is shown.
  217.  
  218.                      PanaPlus densities. 
  219.  
  220.                 Density   X dpi    Y dpi   Comment     
  221.                   1        360       180   no adjustments/dither 
  222.                   2        360       360   no adjustments/dither 
  223.                   3        180       180    
  224.                   4        120       360    
  225.                   5        180       360    
  226.                   6        360       180    
  227.                   7        360       360    
  228.  
  229.                 Name     Sequence   Function       
  230.                 aRIS     ESCc      reset        
  231.                 aRIN     ESC  1    init.        
  232.                 aIND     ESCD      lf           
  233.                 aNEL     ESCE      return,lf    
  234.                 aRI      ESCM      reverse lf   
  235.                 aSGR0    ESC[0m    norm.chars   
  236.                 aSGR3    ESC[3m    italics on   
  237.                 aSGR23   ESC[23m  italics off   
  238.                 aSGR4    ESC[4m   underline on  
  239.                 aSGR24   ESC[24m  underline off 
  240.                 aSGR1    ESC[1m   boldface on   
  241.                 aSGR22   ESC[22m  boldface off  
  242.                 aSFC    SGR30-39  foregrd col.  
  243.                 aSHORP0  ESC[0w  normal pitch   
  244.                 aSHORP2  ESC[2w  elite on       
  245.                 aSHORP1  ESC[1w  elite off      
  246.                 aSHORP4  ESC[4w  condensed on   
  247.                 aSHORP3  ESC[3w  condensed off  
  248.                 aSHORP6  ESC[6w  enlarged on    
  249.                 aSHORP5  ESC[5w  enlarged off   
  250.                 aDEN6    ESC[6"z  shadow on     
  251.                 aDEN5    ESC[5"z  shadow off    
  252.                 aDEN4    ESC[4"z  double on     
  253.                 aDEN3    ESC[3"z  double off    
  254.                 aDEN2    ESC[2"z  NLQ on        
  255.                 aDEN1    ESC[1"z  NLQ off       
  256.                 aSUS2    ESC[2v   super on     
  257.                 aSUS1    ESC[1v   super off    
  258.                 aSUS4    ESC[4v   sub on       
  259.                 aSUS3    ESC[3v   sub off      
  260.                 aSUS0    ESC[0v   normal line  
  261.                 aPLU     ESCL     part. up     
  262.                 aPLD     ESCK     part. down   
  263.                 aFNT0    ESC(B     typeface 0      
  264.                 aFNT1    ESC(R     typeface 1      
  265.                 aFNT2    ESC(K     typeface 2      
  266.                 aFNT3    ESC(A     typeface 3      
  267.                 aFNT4    ESC(E     typeface 4      
  268.                 aFNT5    ESC(H     typeface 5      
  269.                 aFNT6    ESC(Y     typeface 6      
  270.                 aFNT7    ESC(Z     typeface 7      
  271.                 aFNT8    ESC(J     typeface 8      
  272.                 aFNT9    ESC(6     typeface 9      
  273.                 aFNT10   ESC(C     typeface 10     
  274.                 aPROP2   ESC[2p    prop. on        
  275.                 aPROP1   ESC[1p    prop. off       
  276.                 aJFY5    ESC[5 F   auto left       
  277.                 aJFY7    ESC[7 F   auto right      
  278.                 aJFY6    ESC[6 F   auto full       
  279.                 aJFY0    ESC[0 F   justify off     
  280.                 aJFY1    ESC[1 F   word fill       
  281.                 aVERP0   ESC[0z    1/8" spacing    
  282.                 aVERP1   ESC[1z    1/6" spacing    
  283.                 aSLPP    ESC[nt    form length n   
  284.                 aPERF    ESC[nq    perf skip n     
  285.                 aPERF0   ESC[0q    perf skip off   
  286.                 aCAM     ESC  3     Clear margins  
  287.                 aTBC3    ESC[3g     Clear h tabs   
  288.                 aTBC4    ESC[4g     Clear v tabs   
  289.                 aTBCALL  ESC  4     Clr h  tabs  
  290.                 aTBSALL  ESC  5     default tabs   
  291.                 aRAW     ESC[Pn"r   'Pn' raw       
  292.  
  293.  
  294.               The PanaPref Preferences Programs
  295.               =================================
  296.  
  297. Beside all the functions mentioned in the section above, there are
  298. more options unique to the PanaPlus driver.  These options are
  299. managed  using  Commodore's standard environment variables and can
  300. be  controlled  by using the Shell "setenv" and "getenv" commands.
  301. But  setting  environment variables this way can be a very complex
  302. task,  so  a PanaPref preferences program is available to make
  303. the job easy.
  304.  
  305. The PanaPref preferences programs provide an intuitive GUI and
  306. requires  at  least  Workbench  2 to run.  If you are not using at
  307. least Workbench 2 (V37 and above), you must use the Shell commands
  308. for  controlling  the  driver variables (described in detail in an
  309. extra chapter on page envs ).
  310.  
  311. The  PanaPref  preferences  programs  can be controlled by the
  312. mouse and/or the keyboard.  Each gadget of the program corresponds
  313. to  the  underlined  letter  in a gadget.  Pressing that letter is
  314. equivalent  to  clicking  on  the  gadget.  In the case of a cycle
  315. gadget,  you  can use the upper case or lower case letter to cycle
  316. back and forth.  See your system manual on how to control the file
  317. requester by keyboard or mouse.
  318.  
  319. All  windows  are opened directly under your mouse pointer, so you
  320. don't  have  to  move or scroll the screen to control the program.
  321. All  windows  are  opened  on  the default public screen.  You may
  322. specify a special public screen by setting the Tool Type PUBSCREEN
  323. screenname  (the  name  is  case  sensitive) and the PanaPref
  324. preferences  program  will  open  its  windows on your application
  325. program's  screen.   You  can  specify  a  screen  if  you run the
  326. preferences program from a Shell with the
  327.   
  328.                    PanaPref PUBSCREEN  screenname 
  329.  
  330. For  example,  if  you  use  the  ASDG  CEDPro text editor you may
  331. specify    PanaPref   PUBSCREEN   CygnusEdScreen1   and   the
  332. PanaPref  preferences  program  will  open its windows on the
  333. CEDPro  screen.   Make  sure  the  CEDPro  screen is public before
  334. running  the  example.   You need at least CEDPro version 2.12 for
  335. this example.
  336.  
  337. PanaPref is independent, which means they use any system font
  338. you  have chosen in preferences for displaying the text in gadgets
  339. and  windows.  You can force the preferences program to always use
  340. the  topaz 8 font by defining a TOPAZ Tool Type.  This is equal to
  341. using a TOPAZ Shell argument.
  342.  
  343. After  starting  the  preferences  program, the main window opens.
  344. This  contains  several  gadgets  which  the  equivalents  of  the
  345. appropriate  environment  variables.   The  names  and settings of
  346. these environment variables are covered in an extra chapter.  This
  347. chapter  covers  all  you  need  to  know  about  controlling  the
  348. PanaPlus driver via the PanaPref preferences programs.
  349.  
  350.  
  351. Each  gadget  of the PanaPref program will now be described in
  352. detail:
  353.  
  354.                           Fast Graphics
  355.  
  356. If set to on (with a checkmark), the driver sends out graphics
  357. faster to the printer.  While the printing speed can be improved
  358. significantly, printing quality may be loosed and vertical lines
  359. may be printed misaligned.
  360.  
  361.  
  362.                           Separation 
  363.  
  364. You  may print separations with the help of the separation gadgets
  365. in  the  upper right half of the window.  Each primary colour that
  366. is  checkmarked  will  be  printed  (C=cyan,  M=magenta, Y=yellow,
  367. K=black).  An example of the use of the separation function can be
  368. found in the Tips and Tricks chapter.
  369.  
  370.  
  371.                             Mirror 
  372.  
  373. If  set  to  on  (with  a  checkmark),  graphics will be mirrored;
  374. especially  useful  if  you  want  to  print pictures intended for
  375. T-shirt art.
  376.  
  377.                             Silent
  378.  
  379. If  set  to  on  (with  a  checkmark),  printing  will  be done at
  380. half-speed resulting in less noise.
  381.  
  382.                            LineFeed 
  383.  
  384. Many  printers have problems with their internal mechanics causing
  385. unwanted  horizontal  stripes  in  the graphics output.  Often the
  386. linefeed  is  a  bit too much or too little, causing dark or white
  387. horizontal  lines.   This problem is known as `banding'.  LineFeed
  388. allows  you  to  adjust the driver to the mechanical inaccuracy of
  389. the  printer.   Set  LineFeed to -1 if you have white lines in the
  390. output, or +1 if you have dark lines.
  391.  
  392.                            Textcolor 
  393.  
  394. With  the  Textcolor  cycle gadget you may choose the default text
  395. colour for the printer.
  396.  
  397.                            Typeface 
  398.  
  399. The  Typeface  cycle  gadget  allows  you  to  define  the printer
  400. typeface (or `font') selected by the aFNT0.  The typeface selected
  401. with aFNT0 is your default typeface.
  402.  
  403.                       Color Mode/Supergrey
  404.  
  405. Normal Workbench printer drivers are limited to 16 shades of grey.
  406. After  brightening  the  graphics  output,  even  fewer shades are
  407. available.  The Panasonic driver does not have this limitation and
  408. can print colour pictures in up to 256 shades of grey.
  409.  
  410. With  Supergrey enabled, every colour picture will be printed as a
  411. greyscale picture if you select colour instead of greyscale as the
  412. graphics  output  mode.  With Supergrey it is the printer driver's
  413. task  to  convert the colour data into greyscale data.  While this
  414. can  be  done  by the printer device instead of the printer driver
  415. (as normal Workbench drivers do), the PanaPlus printer driver
  416. colour-to-greyscale conversion routines are more precise.  Because
  417. of  this  you  can  print  a  4096 colour HAM picture in up to 256
  418. shades  of  grey  instead of the normal 16 shades.  Supergrey will
  419. replace the normal colour dump of the driver.
  420.  
  421. If  you want to print more than 16 shades of grey (and that's what
  422. Supergrey is all about!) you must define a custom dither matrix in
  423. the  PanaPref  program that enables you to print more than 16
  424. shades.  Defining a dither matrix using PanaPref is described
  425. below.  As default, a 64 shade Halftone A dither is used.
  426.  
  427. Supergrey  works  with  nearly  every  Amiga application simply by
  428. printing  in Workbench's colour mode, even if your printer isn't a
  429. colour  printer.   Application  programs  that  provide  their own
  430. dither  routines  should  not  be used with PanaPlus's custom
  431. dither  routines,  and  because  of  this  should not be used with
  432. Supergrey  .   Programs  with  custom  dither routines include Art
  433. Department    Professional's   PrefPrinter   saver,   TruePrint24,
  434. PageStream.   The  Studio picture-printing program also belongs to
  435. this  category  of  programs, but it automatically detects whether
  436. you are printing in Supergrey or colour.
  437.  
  438. Supergrey can be disabled in several ways.  Take care that none of
  439. the  following  special  cases  are in effect if you want to print
  440. pictures using Supergrey:
  441.  
  442. o PanaPlus's custom dither and colour correction routines can
  443. be  turned  off  by  printing  with  a  Workbench density below 3.
  444. Because  of  this,  Supergrey  works  only with graphics densities
  445. above 2.
  446.  
  447. o PanaPlus's custom dither and colour correction routines can
  448. be  turned  off  by  printing with a Workbench dither method other
  449. than  "ordered".   Because  of this, Supergrey works only with the
  450. "ordered"  dither routine set in Workbench preferences.  This does
  451. not  mean  that you cannot print a halftone dither with Supergrey.
  452. You  just  have  to  use  the PanaPlus dither routines set in
  453. PanaPref  instead  of  the  dither  routines set in Workbench
  454. preferences,  because only the PanaPlus dither routines offer
  455. more than 16 shades of grey.
  456.  
  457. o Supergrey can always be turned of using PanaPref.
  458.  
  459. The  Table  below  shows  all  parameters that must be enabled for
  460. printing with Supergrey.
  461.  
  462.   Function              Density   Workbench dither     
  463.  
  464. Supergrey                 >2          ordered 
  465. Colour Adjustment         >2          ordered 
  466. Ink compensation          >2          ordered 
  467. Driver dithers            >2          ordered 
  468.  
  469. Note:   the  number  of  printable  shades  of  greys in Supergrey
  470. depends on the number of shades supported by the dither method set
  471. in PanaPref.  Up to 256 shades are possible, and supported by
  472. the  PanaPlus  dither  routines.   Often a dither method that
  473. produces 64 shades (default) gives best results.
  474.  
  475.   
  476.   
  477.                                Timeout 
  478.  
  479. Most  people  know  the "Printer trouble..." requester well.  This
  480. system requester most often appears when you print a document that
  481. is  several  pages  long.  The requester is caused by the computer
  482. not  transferring waiting data to the printer for a period of time
  483. (usually  30 seconds).  If there is a `timeout' the printer device
  484. assumes  an  error  and the requester appears.  A timeout may also
  485. appear  without  a real error happening if your printer is waiting
  486. for  (or  slowly  feeding  in)  a new sheet of paper, for example.
  487. This  operation  often needs more than 30 seconds, and during this
  488. time no data is accepted by the printer.
  489.  
  490. With  Timeout you can specify a higher timeout value, resulting in
  491. fewer  timeout  requesters.   A  value  from  1  to 999 seconds is
  492. allowed (default 60 seconds).
  493.  
  494.  
  495. Instead of defining a huge timeout value there is another solution
  496. available:   use  the  CMD  program  (see  your Workbench disk) to
  497. redirect  the  parallel/serial  output  to  a file on disk.  After
  498. this,  use  the Copy command or a printer spooler to copy the file
  499. to  par:   .   This  technique  may also result in a better output
  500. quality, especially with inkjet printers.
  501.  
  502. Note:   If there is a real timeout error you will have to wait the
  503. number  of  seconds  specified by Timeout until an error requester
  504. appears,  thus  allowing  you  to cancel the print job.  So choose
  505. your Timeout value wisely.
  506.  
  507.                                Job End 
  508.  
  509. If  the  printer device gets closed after a dump, you can tell the
  510. driver  to  signal  the  end of the print job.  This is especially
  511. useful on huge graphic dumps which might require some time.  There
  512. are  two  kinds  of signals.  You can cause a beep (Ctrl-G) on the
  513. printer, a DisplayBeep on the Amiga, or both.
  514.  
  515.                                arXon Port 
  516.  
  517. The PanaPlus driver support the arXon parallel switch-box, an
  518. external  1  to 3 Centronics switch controllable by software.  You
  519. can ask the printer driver to automatically switch to the required
  520. port  for  printing,  and  switch back to the previously used port
  521. after  printing.   This  enables you to use a scanner, a digitizer
  522. and  a  printer  from your Amiga's parallel port without having to
  523. switch  between  the  devices manually.  If you specify Default as
  524. the port, no switching will take place.
  525.  
  526. Information about the arXon switch-box may be obtained from:
  527.  
  528.   
  529.                  arXon GmbH 
  530.                  Assenheimer Str. 17 
  531.                  D-W-6000 Frankfurt 
  532.                  Germany 
  533.                  Tel:  010-49-69-7896891 
  534.                  Fax:  010-49-69-7896878 
  535.  
  536.  
  537. The  environment  variable  sbox_active  must  be specified before
  538. using  the driver in order to enable the switch-box feature of the
  539. driver.   This is because sbox active is used to determine whether
  540. a  switch-box  is installed or not.  sbox_active is defined by the
  541. arXon software.
  542.  
  543.                                  Save 
  544.  
  545. You may leave the PanaPref preferences program by clicking on
  546. the  Save  gadget.  Changes made to the settings will be saved for
  547. permanent use.
  548.  
  549.                                   Use 
  550.  
  551. You may leave the PanaPref preferences program by clicking on
  552. the  Use  gadget.   Changes  made  to  the  settings will be saved
  553. temporarily  and will stay active until you reboot the computer or
  554. change the settings using PanaPref again.
  555.  
  556.                                 Cancel 
  557.  
  558. You may leave the PanaPref preferences program by clicking on
  559. the  Cancel  gadget.   Changes  made  to  the settings will not be
  560. recognised or saved.
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.                            More control windows 
  583.                            --------------------
  584.  
  585. There   are   four   gadgets  in  the  bottom  half  of  the  main
  586. PanaPref  window.  The ellipsis (three dots) in these gadgets
  587. means  that  another  window  will  be  opened when you select the
  588. gadget.  Here is detailed description of each of the four windows.
  589.  
  590.  
  591.  
  592.  
  593.                  Customize Tabulators...   Tabulators 
  594.  
  595. The  gadgets  in  this window let you customize the horizontal tab
  596. stops  settings  of  your  printer,  useful  for  printing program
  597. listings  and tables.  Up to 32 tab stops may be defined.  All tab
  598. stops above the limit of 32 are ignored, and a requester will tell
  599. you  so.   Horizontal  tabs are usually selected and stored by the
  600. printer  in  characters,  not  inches.   Thus,  any  change in the
  601. character  spacing can change the physical locations of horizontal
  602. tabs, but the logical positions remain unchanged.
  603.  
  604. You  can  set or unset a tab stop by clicking in the gadget at the
  605. required  position.   A  T  is  used  for a tab stop.  The - and +
  606. characters  are used to help you find the correct position.  Using
  607. the slider below the gadget you can scroll the `tab stops' gadgets
  608. to the required position.
  609.  
  610.                               Clear Tabs 
  611.  
  612. With Clear Tabs you can clear all tab stops.
  613.  
  614.                             Set every n chars 
  615.  
  616. With  the n:  and Set every n chars gadgets you can easily set tab
  617. stops  with the same distance.  Simply enter the distance into the
  618. n:  gadget and select Set every n chars .
  619.  
  620. Note:   the  printer  driver  uses  a  default  distance  of eight
  621. characters.   If  you  want  to  reset  your customized tabs stops
  622. settings  to  the printer default values, simply call up Customize
  623. Tabs...   and  the window will open with a default n:  value of 8.
  624. Press "Set every n chars" to select the default value.
  625.  
  626.                                Use -  Cancel
  627.  
  628. You  can  leave the window with the Use or Cancel gadget.  Changes
  629. made  to  the  tab  stops  settings are accepted with Use.  Cancel
  630. leaves the tab stops unchanged, and any changes made will be lost.
  631.  
  632. Note:   Use  does  not  save the changes made to your environment.
  633. This is done by using the Use or Save gadget in the main window.
  634.  
  635.  
  636.  
  637.                           Page Size and Margins... 
  638.  
  639. The  gadgets  in  this window let you customize the paper size and
  640. margins.   This  window contains many additional settings that are
  641. unknown to most normal printer drivers.
  642.  
  643.                                Enable Form 
  644.  
  645. If  Enable  Form  is checkmarked, page length (as set in Workbench
  646. preferences),  and Perforation Skip will be enabled by the driver.
  647. In order to stay compatible with normal Workbench printer drivers,
  648. by  default  the settings are not used.  Some applications require
  649. well-defined  paper  sizes  and  margins  for printing forms.  The
  650. PanaPlus   driver  provides  you  with  these  facilities  by
  651. checkmarking  Enable  Form.   It  may require some experimentation
  652. (and paper) until you have found the correct values for a specific
  653. application.
  654.  
  655.                              Perforation Skip 
  656.  
  657. Perforation  Skip  specifies  the number of lines that the printer
  658. skips  over  at  the end of each page.  This causes the printer to
  659. skip  the  perforation between pages of continuous forms.  If zero
  660. lines  is  specified,  perforation  skip will be disabled.  If the
  661. specified  value  is  greater than or equal to the form length (as
  662. defined   in   the   Workbench   preferences  program),  the  skip
  663. perforation  is  cancelled  and  the top and bottom margins become
  664. inactive.   The Perforation Skip is only enabled if Enable Form is
  665. checkmarked.
  666.  
  667.                               Page Length 
  668.  
  669. Paper  Length  is  a  read-only gadget showing the paper length as
  670. defined  in  Workbench  preferences.   You  can use the value as a
  671. guide  to  setting  your  perforation  skip and top margin values.
  672. Changes  made  to  the  paper length preferences are automatically
  673. detected  by  the PanaPref program, and the gadget is updated
  674. immediately without the need for exiting PanaPref.  The Paper
  675. Length is only enabled if Enable Form is checkmarked.
  676.  
  677.                              Custom ResX 
  678.                              Custom ResY
  679.  
  680. If  the  selected  paper  format  in  preferences  (Workbench 2.0:
  681. "Printer")  is CUSTOM, this option allows you to specify the width
  682. of  the  printable  area  of paper in inch wide dots.  The size is
  683. used  only  for graphics dumps and does not affect text printouts.
  684. For  example, if you are using Workbench 1.3 (which doesn't have a
  685. DIN  A4  option)  you  can  specify  an  X resolution of 2804 dots
  686. (19.78cm,  7.8in),  which is equal to the DIN A4 size used by most
  687. Commodore  printer  drivers.  If you specify zero (the default) as
  688. the  X  resolution, the US-LETTER resolution of 2880 dots (20.3cm,
  689. 8in) will be used.  The allowed range is 0 to 65535 dots.
  690.  
  691. Similar  to  Custom  ResX,  Custom  ResY defines the height of the
  692. printable paper size.
  693.  
  694.                               Use - Cancel 
  695.  
  696. You  can  leave the window with the Use or Cancel gadget.  Changes
  697. made  to  the  settings  are accepted with Use.  Cancel leaves the
  698. settings unchanged and any changes made will be lost.
  699.  
  700. Note:   Use  does  not  save the changes made to your environment.
  701. This is done by using the Use or Save gadget in the main window.
  702.  
  703.  
  704.  
  705.                   The Color Adjustments...  window.
  706.  
  707. The  gadgets  in this window ebable you to make colour adjustments
  708. and compensate for ink impurities.  But why are colour adjustments
  709. and ink compensation needed?
  710.  
  711.   
  712. o  Most  colour printer users must have come across the problem of
  713. graphics  dumps  being too dark, or the output containing too much
  714. red.  Using the colour adjustment you can easily correct this.  As
  715. default,  the  PanaPlus driver uses a gamma function to bright
  716. up printings.
  717.  
  718. o  The output quality of printers depends ultimately on the ribbon
  719. and type of paper being used.  Using the colour adjustment you can
  720. easily alter the driver to various ribbon and paper types.
  721.  
  722. o  The  colour  adjustment  allows  you  to do image processing by
  723. controlling  the contrast, gamma correction and brightness of each
  724. primary print colour.  You can even filter out unwanted colours.
  725.  
  726. o  Printer  inks (or inks used in ribbons) are not completely pure
  727. materials.   For  example  there  is  some  yellow  mixed into the
  728. magenta  ink,  and there is some magenta in the cyan ink.  The ink
  729. compensation  values  will  correct  for these impurities allowing
  730. blues, for example, to be printed as blues rather than purples.
  731.  
  732.  
  733. Colour  adjustment  is  only  one  of several processes needed for
  734. printing  graphics.   You  can  control the graphics output of the
  735. PanaPlus drivers for each of these processes.
  736.  
  737. Before  the  printer  driver can process a picture for printing it
  738. must  get  separated  into  its  primary  printing  colours.  Each
  739. primary  printing  colour  can  be  adjusted  by  the PanaPlus
  740. printer  driver  using  16  sliders  which  describe  a conversion
  741. function.   Colour  adjustment is needed because the colour values
  742. displayed  on computer monitor and the colours printed by printers
  743. are  different.  A bright red on the monitor, for example, usually
  744. gets printed as dark red; blue is often printed as violet; and the
  745. printer output is often too dark.
  746.  
  747. Most  printers  cannot print two adjacent dots without overlapping
  748. them  slightly.   This  problem  is known as `dot gain' Dot gain ,
  749. causing muddy and dark output.  You can avoid dot gain problems by
  750. printing  with  a  lower resolution (for instance 180 dpi on a 360
  751. dpi  printer)  or  by  using  a  special  dither matrix and colour
  752. adjustment  which  is  not  affected  by  dot  gain  problems (for
  753. instance  Halftone-A  dither,  wich  is  the  default PanaPlus
  754. dither).
  755.  
  756. You  can  control  the  colour adjustment sliders in several ways.
  757. There  are  three  sliders  in  the  upper right half of the Color
  758. Adjustments...   window.  These provide global control over all 16
  759. sliders that describe the conversion function.
  760.  
  761.                           Brightness 
  762.  
  763. The brightness adjustment globally modifies the general brightness
  764. of  a  colour  component.   It does this by uniformly shifting the
  765. colour  map  upwards  or  downwards.  All input intensities of one
  766. primary printing colour will be shifted upwards (made brighter) by
  767. the colour map.  If you brighten all the primary printing colours,
  768. the whole picture gets brighter.
  769.  
  770. The  brightness  adjustment  is not without its drawbacks.  Notice
  771. that  the  darkest  input  value  is brightened, leaving no darker
  772. colours  for  printing.   This means that the darkest intensity in
  773. the  image  will  also be brightened, which may not be acceptable.
  774. Also  note  that  most of the brighter levels now have exactly the
  775. same   intensity  levels,  meaning  that  all  details  which  had
  776. intensity levels in that range are lost.
  777.  
  778. The  brightness  control  in  PanaPref ranges from to 50, with
  779. zero being the neutral value.  Setting the brightness control to a
  780. positive  value uniformly shifts the colour map upwards, towards a
  781. brighter colour component.  Similarly, a negative value causes the
  782. colour to be shifted towards darkness.
  783.  
  784.                             Contrast 
  785.  
  786. The  contrast adjustment globally modifies the general contrast of
  787. a  colour  component.   Contrast  adjustments can be visualized by
  788. thinking of the neutral colour map being pivoted around its centre
  789. point.   At  one  extreme the colour map becomes flat, which means
  790. that  all  input  intensities map to the same output intensity (no
  791. contrast).  The other extreme is a vertical line for a colour map,
  792. which  produces  a  primary  colour  with  exactly two intensities
  793. (maximum contrast).
  794.  
  795. Notice  again  that  contrast  loses some amount of visual detail,
  796. just  as  the  brightness adjustment does.  This may or may not be
  797. acceptable for any given image.
  798.  
  799. The  contrast control in PanaPref ranges from to 50, with zero
  800. being  the  neutral  value.   Setting  the  contrast  control to a
  801. positive  value  uniformly pivots the colour map around its centre
  802. in  an  anti-clockwise  direction  (towards  the  vertical), which
  803. increases visible contrast.
  804.  
  805.                              Gamma 
  806.  
  807. The  gamma  adjustment  provides a way to significantly brighten a
  808. colour component without losing that much detail.  It does this by
  809. introducing a curve into the colour map, whereby the colour map is
  810. shifted   upwards   or   downwards   (made   brighter   or  darker
  811. respectively) but no portion of the colour map gets clipped to the
  812. maximum or minimum values.
  813.  
  814. The  gamma  adjustment  also  affects  the  contrast of the colour
  815. component.   In  the  darker  part  of  the  spectrum  contrast is
  816. increased;  in  the  lighter  part  of  the  spectrum  contrast is
  817. decreased.
  818.  
  819. The  gamma  control  in PanaPref ranges from -50 to +50, where
  820. zero represents no gamma adjustment.
  821.  
  822. The   overall   effect   of  gamma  adjustment  is  usually  quite
  823. satisfactory  and we recommend its liberal use.  There are several
  824. reasons  for  this.   The  gamma  function provides an easy way to
  825. brighten  a  picture  without  losing detail.  Also, monitor tubes
  826. show  a  computer  picture using a non-linear conversion function,
  827. and  this  function  is very similar to the gamma function.  Using
  828. the  gamma  function  allows  you to more easily adapt the printer
  829. output to the monitor picture.
  830.  
  831.                               Set 
  832.  
  833. "Set" globally sets all 16 adjustment sliders of the active colour
  834. component  to  the  values  defined  by the Gamma, Brightness and
  835. Contrast sliders.
  836.  
  837.                 Invert    Bright+/-   Default 
  838.  
  839. Beside  "Set" there are more gadgets providing global control over
  840. the  16  adjustment  sliders.  Invert inverts all 16 sliders.  The
  841. two  "Bright"  gadgets  allow  you  to  increase  or  decrease the
  842. brightness  of all 16 sliders.  "Default" resets all 16 sliders to
  843. the default values wich is equal to a gamma correction of +32.
  844.  
  845.                        Adjustment sliders 
  846.  
  847. The  16 colour adjustment sliders in the middle of the window give
  848. you  precise  control  over  the colour adjustment function of the
  849. driver.   Each  slider  can be set to one of 256 shades.  A higher
  850. level  means  less  of  the  currently selected primary colour.  A
  851. lower  level  means more colour, causing a darker picture.  All 16
  852. sliders describe a conversion function Conversion function .  Dark
  853. input  values  are  adjusted  by  the  sliders to the left, bright
  854. colours  are adjusted by the sliders to the right.  As soon as you
  855. click  on  one of the sliders, the value represented by the slider
  856. is shown in the Level gadget on the left-hand side of the window.
  857.  
  858. Colour  pictures  are printed by most printers using three or four
  859. primary  colours.  Usually these colours are cyan, magenta, yellow
  860. and  black.   (Black  is  not  used by DeskDriver).  All 16 colour
  861. adjustment  sliders  are  applied  to one primary colour.  You can
  862. choose which primary colour to adjust using the Color cycle gadget
  863. in the upper left-hand corner of the window.
  864.  
  865. But  what  if  you  want  to  use the gamma function to brighten a
  866. greyscale picture?  For this purpose select B/W-Grey as the colour
  867. and  use  the  gamma  slider to select the required gamma setting.
  868. Apply  the  gamma setting to the 16 adjustment sliders by clicking
  869. on the "Set" gadget.  After leaving the PanaPref program using
  870. "Use" or "Save", the gamma function is active.
  871.  
  872.  
  873. While each of the 16 colour sliders provides 256 levels, this does
  874. not necessarily mean you can print 256 shades of each colour.  The
  875. number  of  colours  or  shades printed depends upon the number of
  876. colours  or shades supported by the dither matrix being used.  The
  877. PanaPlus  installation  program  installs an Halftone-A dither
  878. method  with  64  shades  as  the  default  dither  routine.  More
  879. information  about setting up a dither matrix can be found on in a
  880. chapter below.
  881.  
  882.                           Push   Pop 
  883.  
  884. Now,  say  you  want  to  apply  a specific gamma function to each
  885. primary  colour.   Sure,  you  could  use  the  same technique for
  886. installing  the  gamma  function as described in the example above
  887. for  every  primary colour.  But this technique can be a real pain
  888. if  you  have adjusted some sliders by hand.  This is why the Push
  889. and  Pop  gadgets  got  introduced.   Push  saves all your current
  890. slider  settings  on  to  the  stack.   After  changing the colour
  891. component  you  can easily Pop the settings from the stack.  Using
  892. Pop for every colour component is fast and easy.
  893.  
  894.                           Load   Save 
  895.  
  896. You  can  save  the  your colour adjustment function to a file for
  897. later  use.   You  could save your adjustment settings for various
  898. kind  of  paper  types,  for example, and reload them when needed.
  899. Save  will  cause  the system file requester to appear and you can
  900. choose  a  path and filename for saving.  Load will cause the file
  901. requester to appear and you can choose the file for loading.  Note
  902. that  Save  and  Load  only  affect  the currently selected colour
  903. component.
  904.  
  905.                         Comp M   Comp Y 
  906.  
  907. The  integer  gadgets  Comp.  M and Comp.  Y can be used to adjust
  908. the  ink compensation of the printer driver.  Printer inks used in
  909. ribbons  are  not completely pure materials.  For example there is
  910. some  yellow mixed into the magenta ink, and there is some magenta
  911. found  in  the cyan ink.  The ink compensation values will correct
  912. for these impurities allowing blues, for example, to be printed as
  913. blues rather than purples.
  914.  
  915. Comp.   M  defines  the percentage of magenta ink in the cyan ink.
  916. Comp.  Y defines the percentage of yellow ink in the magenta ink.
  917.  
  918. PanaPlus's custom dither and colour correction routines can be
  919. turned  off  by printing with a Workbench dither method other than
  920. "ordered",  or  a  density  below  3.   Because  of  this,  colour
  921. adjustment  and ink compensation work only with the ordered dither
  922. routine set in Workbench preferences and densities above 2.
  923.  
  924. Colour  adjustment  works  with  nearly  every  Amiga application.
  925. Application  programs  with  their  own colour adjustment routines
  926. should not be used with PanaPlus's routines enabled.  Programs
  927. with  their  own colour adjustment routines include Art Department
  928. Professional's PrefPrinter saver, TruePrint24 and PageStream.  Use
  929. density  1  or  2  when  printing with these programs.  The Studio
  930. picture-printing   program   also  belongs  to  this  category  of
  931. programs,  but it automatically disables the PanaPlus driver's
  932. colour adjustment routines.
  933.  
  934.                          Use    Cancel 
  935.  
  936. You  can  leave the window with the Use or Cancel gadget.  Changes
  937. made  to  the settings are accepted with "Use".  Cancel leaves the
  938. settings unchanged and any changes made will be lost.
  939.  
  940. Note:   Use  does  not  save the changes made to your environment.
  941. This  is  achieved  by  using  the  Use or Save gadget in the main
  942. window.
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.                Customize Dither...  Dither Routines
  955.  
  956. Most printers print pictures using a `binary coding', or to put it
  957. more  simply:   a  dot can either be printed, or not.  There is no
  958. way  to  control  the  brightness  of  a single dot.  A monochrome
  959. printer  can  only  print  one  colour:   black.   Colour printers
  960. support  the  printing  of  three  or four primary colours:  cyan,
  961. magenta, yellow and black.
  962.  
  963. A  special  technique  is needed for printing more shades.  Dither
  964. routines  provide such a technique.  Dither routines print dots of
  965. a  primary  colour in various patterns, creating the impression of
  966. different  shades,  thanks  to  the  fact that the human eye can't
  967. distinguish adjacent dots from a distance.
  968.  
  969. Each  pixel  of a picture produces a pattern of printed dots.  The
  970. pattern  is  described  by  a  dither matrix.  There are almost no
  971. limits  to  the  size  of  the  dither  matrix.   Workbench dither
  972. matrices  (ordered  and halftone) are of the size , which is equal
  973. to  printing  shades  A normal matrix produces 17 shades.  This is
  974. not  true  in  case  of  the Workbench dither matrix.  .  A matrix
  975. consists  of threshold values.  Each matrix value is compared with
  976. the  picture's  pixel  value.  If the value of the pixel is higher
  977. than the matrix value, a dot gets printed.
  978.  
  979. Dither  patterns  allow you to print a huge number of shades.  The
  980. number  of  printable  shades  mainly  depends  on the size of the
  981. dither matrix used and the quality of the printer.
  982.  
  983. Many printers have problems with overlapping dots.  These problems
  984. have a huge influence on the decision as to which dither matrix to
  985. use.   There is also a strong relationship between a dither matrix
  986. and  the  colour  adjustment  required.  A change of print density
  987. often  requires  a  change  of  the  dither  matrix  and/or colour
  988. adjustment,  and  changing  the dither matrix usually requires the
  989. colour adjustment also to be changed.
  990.  
  991. PanaPlus  gives you the facilities to define the dither matrix
  992. used  for  printing.   Many  dither  matrices  are  included  with
  993. PanaPlus.   These  are handled in an extra below chapter; this
  994. chapter  covers  only  the use of the Customize Dither...  window.
  995. This  window  allows  you  to  edit  the  current  dither pattern.
  996. Instead of editing a pattern, you may quickly load a pattern using
  997. the window shown after selecting "Customize Dither...".
  998.  
  999. The theoretical aspects of digital halftoning are complex, and are
  1000. way  beyond  the  scope  of this manual.  If you are interested in
  1001. more detailed information, a very good book can be recommended:
  1002.  
  1003.                  Robert Ulichney 
  1004.                  Digital Halftoning 
  1005.                  MIT Press 
  1006.                  ISBN 0-262-21009-6 
  1007.  
  1008. The  book  is  easy to understand and comes with lots of examples.
  1009. Most  of the dither routines used by PanaPlus are described in
  1010. detail in this book.
  1011.  
  1012.   
  1013.                           Load   Save 
  1014.  
  1015. Using the Customize Dither...  window is very similar to using the
  1016. Color Adjustments...  window.  The Load and Save gadgets allow you
  1017. to  load  and  save  the  required  dither matrix for a particular
  1018. colour  component.  Only the currently selected Color component is
  1019. saved or loaded.
  1020.  
  1021.                           Push   Pop 
  1022.  
  1023. Let's assume you want to print a colour picture using the halftone
  1024. dither.   There are two ways you can enable the halftone dither in
  1025. PanaPref.  You can either load the dither matrix from disk for
  1026. each  primary  colour, or you can use the stack.  The stack can be
  1027. controlled using the Push and Pop gadgets on the left-hand side of
  1028. the window.
  1029.  
  1030. All  you  have  to  do to install the required dither matrix is to
  1031. load  the  dither.   Afterwards  click  on the Push gadget and the
  1032. dither  is  saved  on to the stack.  Now switch the primary colour
  1033. and  Pop  the  matrix  from  the stack.  Enable the matrix for all
  1034. primary  colours  by  using the stack.  You can switch between the
  1035. primary colours by using the Color cycle gadget Color .
  1036.  
  1037. A  PanaPlus dither matrix may be any rectangular shape and can
  1038. consist  of  up to 512 values.  Up to 64 values can be included on
  1039. each  row  (X)  or column (Y).  You can use the X and Y sliders to
  1040. define  the size of the matrix.  The current size of the matrix is
  1041. shown on the left-hand side of the window.
  1042.  
  1043. PanaPlus's  custom  dither  routines  can  be  turned  off  by
  1044. printing  with a Workbench dither method other than ordered , or a
  1045. density below 3.
  1046.  
  1047. The   custom   dither  routines  works  with  nearly  every  Amiga
  1048. application.   Application  programs that provide their own dither
  1049. routines  should not be used with PanaPlus's routines enabled.
  1050. Programs  that  do  not work include Art Department Professional's
  1051. PrefPrinter saver, TruePrint24 and PageStream.  Use density 1 or 2
  1052. when  printing  with  these programs.  The Studio picture-printing
  1053. program  also  belongs  to  this  category  of  programs,  but  it
  1054. automatically disables the PanaPlus driver's dither routines.
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.                          Dither Routines 
  1072.  
  1073. Many  dithering  methods are supplied with PanaPlus, and these
  1074. are  described  below.   In  each  case  a larger dither mask size
  1075. produces  a printout which can represent a wider range of colours,
  1076. but  will produce less spatial information per unit area of paper.
  1077. Conversely, a smaller dither mask size can reproduce fewer colours
  1078. (or  shades)  but more closely approximates the true resolution of
  1079. your printer.
  1080.  
  1081. Another  way of expressing this is simply that there is a tradeoff
  1082. between   printing  ``lots''  of  colours  and  printing  in  high
  1083. resolution.    Given  a  specific  printer  with  a  specific  DPI
  1084. capability,  asking  for  ``lots'' of colours means using a larger
  1085. dither  mask  size.   A  larger dither mask size cuts down on your
  1086. effective  resolution.  For instance, using a dither mask of 16*16
  1087. on  your  360  dpi printer will result in 360 / 16 = 22,5 dpi This
  1088. values  is  often  described as l/inch (lines per inch) or `screen
  1089. frequency'.  with full colour information.
  1090.  
  1091. Note  that  this  can  work  to  your  advantage  when enlarging a
  1092. picture.   Enlarging  means that there are more dots to work with,
  1093. which  offsets  the  loss  in resolution caused by a larger dither
  1094. mask size.  This, added to the benefits to be had by being able to
  1095. reproduce more colours (or shades).
  1096.  
  1097. Also  note  that  many printers, including most laser printers and
  1098. dot-matrix  printers,  have  considerable  dot gain problems.  For
  1099. example,  a 360 dpi printer does not actually print dots which are
  1100. of  an  inch in size.  Rather, its dots will be much larger.  This
  1101. causes  some  dithers,  such  as  the  Ordered dithers, to produce
  1102. intensely  over-saturated  or `muddy' prints.  Other dithers, such
  1103. as  the  two  halftone dithers, overcome this problem with low-end
  1104. printers.
  1105.  
  1106. If  you  want  to  learn  more  about  dither routines and digital
  1107. halftoning, here is a very good book to go for:
  1108.  
  1109.                  Robert Ulichney 
  1110.                  Digital Halftoning 
  1111.                  MIT Press 
  1112.                  ISBN 0-262-21009-6 
  1113.  
  1114. The  book  is  easy to understand and comes with lots of examples.
  1115. Most  of the dither routines used by PanaPlus are described in
  1116. detail in this book.
  1117.  
  1118. See  the  description  of  the  "Customize  Dither..."  window for
  1119. information  on  how  to  enable  a  required dither routine for a
  1120. PanaPlus printer driver.
  1121.  
  1122. OK, now let's discuss the dither routines in detail:
  1123.  
  1124. While  using  the PanaPref program, click on the button marked
  1125. "Customize Dither..."  for using one of the dithers described below.
  1126.  
  1127. Several   popular   ordered   dither  methods  are  provided  with
  1128. PanaPlus  and  saved  in files.  These files can be loaded and
  1129. enabled  with  the  Load gadget or by using a listview shown after
  1130. clicking on Customize Dither...  .
  1131.  
  1132. The number of printable colours is usually directly related to the
  1133. size  of  the  dither matrix.  Most of the ordered dither routines
  1134. described  below  exist  in  several  sizes.   You can distinguish
  1135. between  them  by  their  filenames.   For  instance a filename of
  1136. "Halftone-A-4"  means  the Halftone A dither routine for 4 shades;
  1137. while "Halftone-A-256" means the Halftone A dither routine for 256
  1138. shades.
  1139.  
  1140.               Halftone-A -  number of colors  
  1141.               Halftone-B -  number of colors  
  1142.  
  1143. 10 Percent   20 Percent   50 Percent   80 Percent   90 Percent
  1144.  
  1145.                               ****     ********     ********
  1146.       *          ***          ****        *****     ** *****
  1147.      **          ***          ****        *****     *  *****
  1148.                               ****     ********     ********
  1149.                           ****         ********     ********
  1150.  **          ***          ****         ****   *     ****** *
  1151.  **          ***          ****         ****   *     *****  *
  1152.               *           ****         ********     ********
  1153.  
  1154.  
  1155. The  halftone  dithers  (Halftone-A  and Halftone-B) differ in how
  1156. they place a halftone matrix.
  1157.  
  1158. This  is  the  classic clustered halftone method used by most book
  1159. publishers,  and  PostScript.   To  improve  the dither output the
  1160. halftone  matrix  is rotated by 45 degrees.  Halftone-A causes the
  1161. halftone  matrix  for  each  of  the primary colours to be centred
  1162. about  the  same  point.  This means that the primary colours will
  1163. overlap  completely, leaving a lot of white paper showing through.
  1164. This  may  be  appropriate  for  some  better dye-sublimation type
  1165. printers,  or  other  colour printers with good registration where
  1166. the inks mix well.
  1167.  
  1168. Halftone-B,  on  the  other  hand, staggers the halftone matrix of
  1169. each  primary colour so that they do not overlap.  This is similar
  1170. in  concept to traditional colour offset printing.  Halftone-B may
  1171. produce better results on printers whose inks do not mix well, and
  1172. on printers with less than perfect registration.
  1173.  
  1174. The  halftone  dithers can produce some extremely good results and
  1175. compensate  for  the  dot  gain problems outlined above.  Try both
  1176. halftone  dithers  to  see which one is better for your particular
  1177. intention.   If  you  are going to photocopy your printouts, using
  1178. Halftone results in a much better copy.
  1179.  
  1180. Halftone-B  is  somewhat  different  to the other dither matrices.
  1181. You  have  a  special  dither  matrix for each colour.  Because of
  1182. this,  each dither filename includes the abbreviation of the color
  1183. (C = cyan, Y = yellow, M = magenta, K = black or greyscale).
  1184.  
  1185. If  you  are using Halftone-B with one of the PanaPlus printer
  1186. driver,  you  must  increase  the  brightness  of the black colour
  1187. component  by  50%.   Use  the  bright+ gadget in the PanaPref
  1188. preferences programs for increasing brightness.
  1189.  
  1190. Halftone-B  is  a  good example of the relationship between colour
  1191. adjustment  and  dither  routines.   You  have  to  consider  both
  1192. settings.
  1193.  
  1194.  
  1195.                      PrtDevice-Halftone-16
  1196.  
  1197.  10%    20%    30%     40%   50%     60%    70%    80%    90%
  1198.  
  1199.           *    *  *   *  *   *  *   *  *   *  *   ** *   ****
  1200.  *      *       **     **     **    ***    ****   ****   ****
  1201.         *       **     **     **     **     **     **    ****
  1202.    *      *       *      *   *  *   * **   ****   ****   ****
  1203.  
  1204.  
  1205.  
  1206.                      PrtDevice-Ordered-16 
  1207.  
  1208.  10%    20%    30%     40%   50%     60%    70%    80%    90%
  1209.  
  1210.  *      * *    * *    * *    * *    ***    ****   ****   ****
  1211.                 *      * *    * *    * *    * *   ** *   ****
  1212.    *    * *    * *    * *    * *    * **   ****   ****   ****
  1213.                          *    * *    * *    * *    * *   ****
  1214.  
  1215. This  dither  matrix  is  the  one  used  by the Workbench printer
  1216. devices Halftone or Ordered dither.
  1217.  
  1218. The  dispersed ordered dither produces a regular repeating pattern
  1219. which  is  often used for printing computer graphics.  The ordered
  1220. dither  is  particularly  vulnerable to over-saturation due to dot
  1221. gain  in  high  resolutions.   But you will get good output if you
  1222. don't use the maximum print density of your printer (for instance,
  1223. by using 180 dpi on a 360 dpi printer).
  1224.  
  1225.  
  1226.                        Ordered-A-Dither
  1227.  
  1228.     10 Percent  20 Percent  50 Percent  80 Percent  90 Percent
  1229.     *   *       *   * *     * * * *     * * * *     * ******
  1230.                              * * * *    ********    ********
  1231.       *   *     * * * *     * * * *     *** ***     *** *** 
  1232.                              * * * *    ********    ********
  1233.     *   *       *   *       * * * *     * * * *     ***** **
  1234.                              * * * *    ********    ********
  1235.           *     * * * *     * * * *     *** ***     *** *** 
  1236.                              * * * *    ********    ********
  1237.  
  1238. The  dispersed ordered dither produces a regular repeating pattern
  1239. which  is  often used for printing computer graphics.  The ordered
  1240. dither  is  particularly  vulnerable to over-saturation due to dot
  1241. gain  in  high  resolutions.   But you will get good output if you
  1242. don't use the maximum print density of your printer (for instance,
  1243. by using 180 dpi on a 360 dpi printer).
  1244.  
  1245.                         Ordered-B-Dither 
  1246.  
  1247.     10 Percent  20 Percent  50 Percent  80 Percent  90 Percent
  1248.     *           **  **      **  **      ********    ********
  1249.     **          **  **      **  **      ********    ********
  1250.                               **  **      **  **    ***** **
  1251.                               **  **      **  **    **** ***
  1252.         **      *   **      **  **      ********    ********
  1253.         **          **      **  **      ********    ********
  1254.                               **  **      ******      ******
  1255.                               **  **      ******      ******
  1256.  
  1257. This  dither is a mixture of a dispersed dither like Ordered and a
  1258. clustered dither like Halftone.  The dither is meant specially for
  1259. high resolution printers with dot gain problems.  For instance, if
  1260. you print a picture with 360*360 dpi using Ordered-B-64, you get a
  1261. picture  that  appears  to  be  printed at 180*180 dpi.  But while
  1262. colours  are printed emulating 180*180 dpi, all the black parts of
  1263. the  picture  are  printed using 360*360 dpi.  Don't get confused,
  1264. the printed picture is still better than a picture in real 180*180
  1265. dpi  resolution.   The  Ordered-B  dither is especially useful for
  1266. colour  DTP because you can combine good colour pictures with fine
  1267. high quality text.
  1268.  
  1269.                Spiral-Dot-Screen -  number of colors  
  1270.  
  1271.     10 Percent  20 Percent  50 Percent  80 Percent  90 Percent
  1272.                                         ********    ********
  1273.                              ******     ********    ********
  1274.       *           ****       ******     ********    ********
  1275.       ***         ****       ******     *******     ********
  1276.       ***         ****       ******     *******     ********
  1277.                      *       ******     *******     ********
  1278.                                  **     *******     ********
  1279.                                                           **
  1280. A  wide  range  of  special  effects clustered-dither matrices are
  1281. available  in  the  graphic  arts  industry,  and  all  are easily
  1282. simulated digitally.  Spiral-Dot is such a dither.
  1283.  
  1284. The  spiral-dot  dither  is  essentially  half  of  the  classical
  1285. `screen',  with dark squares growing to fill the plane without the
  1286. alternating  light squares.  Spiral-Dot looks quiet similar to the
  1287. Halftone-A matrix, zero degree rotated.
  1288.  
  1289.  
  1290.                   Horizontal -  number of colors  
  1291.                    Vertical -  number of colors  
  1292.  
  1293.     10 Percent  20 Percent  50 Percent  80 Percent  90 Percent
  1294.                                          *******    *********
  1295.                               *****     *********   *********
  1296.                    ****     *********   *********   *********
  1297.      *******    *********   *********   *********   *********
  1298.                             *********   *********   *********
  1299.                                         *********   *********
  1300.                                                        ****
  1301.  
  1302. A  wide  range  of  special  effects clustered-dither matrices are
  1303. available  in  the  graphic  arts  industry,  and  all  are easily
  1304. simulated digitally.  The Line dithers are such dithers.
  1305.  
  1306. The  horizontal (as well as the vertical) dither overcomes many of
  1307. the  dot  gain problems that the Ordered dithers have with low-end
  1308. printers.   These  dithers (particularly the diagonal dithers) are
  1309. especially good for large pictures.
  1310.  
  1311.                     Fwd-Brick-  number of colors  
  1312.                     Bck-Brick-  number of colors  
  1313.  
  1314.     10 Percent  20 Percent  50 Percent  80 Percent  90 Percent
  1315.     **          ***         *****       *******     ********
  1316.     *           **          ****        ****** *    ****** *
  1317.                 *           ***    *    ****  **    ***** **
  1318.                             **    **    ***  ***    **** ***
  1319.                             *     **    **  ****    *** ****
  1320.                        *         ***    *  *****    ** *****
  1321.            *          **        ****      ******    * ******
  1322.           **         ***       *****     *******     *******
  1323.  
  1324. A  wide  range  of  special  effects clustered dither matrices are
  1325. available  in  the  graphic  arts  industry  and  all  are  easily
  1326. simulated digitally.  The Brick dithers are such dithers.
  1327.  
  1328. The Forward-Brick (as well as the Backward-Brick) dither overcomes
  1329. many of the dot gain problems that the error diffusion, Blue Noise
  1330. and Ordered dithers have with inexpensive printers.  These dithers
  1331. are especially good for enlarged pictures.
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.                         Tips & Tricks 
  1340.                         =============
  1341.  
  1342.              Colour printing with b/w printers
  1343.  
  1344. You  are  able  to print colour graphics on monochrome printers by
  1345. manually  switching  colour  ink  cartridges  or  ribbons.  Colour
  1346. printing  can  be achieved by using the separation function of the
  1347. PanaPlus driver:
  1348.  
  1349. o  Use  the  Separation  gadgets  of  the PanaPref preferences
  1350. program  to turn off all primary print colours except yellow.  Put
  1351. a yellow ribbon/ink cartridge into your printer.
  1352.  
  1353. o Print a colour picture from your application using the Workbench
  1354. colour mode.
  1355.  
  1356. o  Repeat  the steps above for each primary colour, using the same
  1357. sheet of paper.
  1358.  
  1359. Note that reinserting the sheet of paper usually causes mechanical
  1360. problems that result in a loss of print quality.
  1361.  
  1362. Most  likely,  the  colour  and  brightness  of the output will be
  1363. wrong.   Changing the dither method may improve the output quality
  1364. dramatically.   Try  both  a  dispersed  Ordered  and  a clustered
  1365. Halftone dither, and use the one that fits your printer best.
  1366.  
  1367. Also,  start  printing  with  the  brightest primary colour.  This
  1368. avoids the possible pollution of brighter colour ribbons.
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.                         Errors & Fixes
  1375.                         ==============
  1376.  
  1377. For those who deal with computers and printers, it's a known fact:
  1378. Everything  possible that can go wrong, will go wrong.  Especially
  1379. when it comes to printing, there are many places were you can make
  1380. mistakes.
  1381.  
  1382. If  you  find a problem with a PanaPlus printer driver, please
  1383. send  a  description  which  makes  it  possible  to reproduce the
  1384. problem.    For   this   purpose,  you  should  provide  following
  1385. information:
  1386.  
  1387.   
  1388. o Which application program are you using, and which version of it?
  1389. o Which Workbench revision are you using?
  1390. o Include  a  dump of the program, as a file (use the CMD program
  1391.   from the Workbench disk for this) and in printed form.
  1392. o If possible, provide a copy your Workbench disk or application,
  1393.   already set up for printing.
  1394.  
  1395.  
  1396.                         Par:  or  Prt:? 
  1397.  
  1398. Data should be sent to the printer only via parallel.device (par:)
  1399. or  printer.device  (prt:),  and not both at the same time as this
  1400. may confuse the printer.
  1401.  
  1402.                             No dump?
  1403.  
  1404. If the printer device immediately reports an error while trying to
  1405. print  a  graphic,  check  that you have selected the PanaPlus
  1406. printer driver in Workbench preferences.
  1407.  
  1408.                    No way for Kickstart 2&3?
  1409.  
  1410. Your  printer  doesn't  work  under  Kickstart  2 or 3, while with
  1411. Kickstart  1.3  it  works  fine?   Check the "on-line" and "out of
  1412. paper"  lines  in the printer cable.  Make sure they are connected
  1413. correctly.  If your cable is wired right, check the two Amiga port
  1414. chips  named  8520.   There have been major changes in Kickstart 2
  1415. regarding  the use of the port chips.  Ask your dealer for help if
  1416. these tips are too technical for you!
  1417.  
  1418.                           Empty pages?
  1419.  
  1420. Empty  pages  is  a known problem of Amiga printer drivers.  After
  1421. graphics  dumps an empty page is printed.  So far there is no 100%
  1422. cure  for  this problem.  Some application programs don't cause an
  1423. empty page if you enable the Continuous paper type in preferences.
  1424.  
  1425.                        Printer trouble... ?
  1426.  
  1427. Printer trouble...  requester?  Have a look at the TimeOut setting
  1428. of  the  PanaPref program.  Setting a longer Timeout can avoid
  1429. such  requesters.  Anyway, clicking on the Resume button continues
  1430. printing without loss of data.
  1431.  
  1432.                            No Formfeed?
  1433.  
  1434. If a page is not ejected, check your paper type preferences.  Make
  1435. sure Single is selected as the paper type.  Deluxe Paint users may
  1436. run  into  the  problem  of  an endless graphic dump -- the Deluxe
  1437. Paint  print  requester  won't  disappear, and the printer doesn't
  1438. eject  the  page.   This is a known bug in Deluxe Paint and can be
  1439. easily cured by a mouse click in the Deluxe Paint print requester.
  1440.  
  1441.                Differences between KS 2  and KS 1.3? 
  1442.  
  1443. After  switching  from Workbench 1.3 to 2/3 your graphic dumps are
  1444. of  different  size?   This most likely will happen to users using
  1445. the DIN A4 paper size.  For instance, under Workbench 1.3 you used
  1446. the Letter size, and after switching to Workbench 2/3 you used the
  1447. DIN  A4  size.   Because PanaPlus supports the new paper sizes
  1448. (DIN  A4,  A5  ...),  you get a different printout under Workbench
  1449. 2.0/2.1.   Simply  switch  back to the Letter size to get the same
  1450. result as under Workbench 1.3.
  1451.  
  1452.                          Patching drivers
  1453.  
  1454. There  are  several  programs  that  allow  you to `patch' printer
  1455. drivers in order to alter specific commands or parameters like the
  1456. Timeout value.  Do not use these programs!
  1457.  
  1458.                          To dark pictures?
  1459.  
  1460. If your graphic dumps are too dark or wrongly coloured, it is most
  1461. likely  caused  by  the disabled colour adjustment routines of the
  1462. PanaPlus driver.
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.                           Environment Vars 
  1481.  
  1482. If  you  have never heard of `environment variables', this chapter
  1483. is  not  for  you.  But don't panic, you won't be missing anything
  1484. unless you are still using Workbench 1.3.
  1485.  
  1486. So  this  chapter  is mainly of interest to experienced users.  It
  1487. covers  controlling  the  PanaPlus driver from ARexx, Shell or
  1488. batch files.
  1489.  
  1490. You  may  set  options  for  the  PanaPlus driver by using the
  1491. setenv  and  getenv  Shell  commands  instead  of the PanaPref
  1492. preferences  program.   Setenv  saves your option in a file in the
  1493. ENV:    directory.    See   your  system  manual  for  a  complete
  1494. description  of  the  setenv and getenv commands.  The driver will
  1495. read  in  the  arguments  upon opening the printer device.  If you
  1496. don't have enough memory, the driver refuses to open.
  1497.  
  1498.  
  1499. Note:   setting  options  does  not  always  mean they take effect
  1500. immediately.   So  if you make changes by using setenv , flush the
  1501. driver  out of memory (AVAIL FLUSH) or run InitPrinter in order to
  1502. let   the  driver  know  about  your  changes.   The  PanaPref
  1503. preferences programs will do this for you automatically.
  1504.  
  1505. Remember  that environment variables (which are stored in the ENV:
  1506. directory)  are  normally erased by re-booting.  If you don't want
  1507. to  set  the  environment  variables  every time you boot, you can
  1508. place  them  in  ENVARC:  (Workbench 2/3) or assign ENV:  to a non
  1509. volatile  disk  (Workbench  1.3).  Make sure you use the Commodore
  1510. setenv command to set environment variables.  Environment variable
  1511. names are not case sensitive.
  1512.  
  1513. OK, now a description of every environment variable in detail:
  1514.  
  1515.   
  1516.            sbox_printer     0|1|2|3   (default: 0) 
  1517.  
  1518. PanaPlus  support the arXon parallel switch-box, an external 1
  1519. to  3 Centronics switch controllable by software.  You can ask the
  1520. printer  driver  to  automatically switch to the required port for
  1521. printing,  and  switch  back  to  the  previously  used port after
  1522. printing.   This  enables  you to use a scanner, a digitizer and a
  1523. printer  from  your Amiga's parallel port without having to switch
  1524. between the devices manually.  If you specify Default as the port,
  1525. no switching will take place.
  1526.  
  1527. Information about the arXon switch-box may be obtained from:
  1528.  
  1529.   
  1530.                         arXon GmbH 
  1531.                         Assenheimer Str. 17 
  1532.                         D-W-6000 Frankfurt 
  1533.                         Germany 
  1534.                         Tel:  010-49-69-7896891 
  1535.                         Fax:  010-49-69-7896878 
  1536.  
  1537. The  environment  variable  sbox  active  must be specified before
  1538. using  the driver in order to enable the switch-box feature of the
  1539. driver.   This is because sbox active is used to determine whether
  1540. a  switch-box  is installed or not.  sbox_active is defined by the
  1541. arXon software.
  1542.  
  1543.  
  1544.                       PanaGAdj: <Num1-16>
  1545.                       PanaCAdj: <Num1-16>
  1546.                       PanaMAdj: <Num1-16>
  1547.                       PanaYAdj: <Num1-16>
  1548.                       PanaKAdj: <Num1-16>
  1549.  
  1550. (default: 0 90 117 137 153 167 179 190 200 210 218 226 234 241 248 255)
  1551.  
  1552. You  may  define  a colour adjustment function using 16 values for
  1553. each primary print colour (G=grey, C=cyan, M=magenta, Y=yellow and
  1554. K=black).  Each of the 16 values must be in the range 0 (black) to
  1555. 255  (white).   The  brightness of the input values increases from
  1556. left to right (0 to 255).
  1557.  
  1558.                   PanaBeep: 0|1|2|3  (default: 0) 
  1559.  
  1560. If  the  printer device gets closed after a dump, you can tell the
  1561. driver  to  signal  the  end of the print job.  This is especially
  1562. useful  with  huge  graphic  dumps  which might require some time.
  1563. There  are two kinds of signals.  You can cause a beep (Ctrl-G) on
  1564. the printer, a DisplayBeep on the Amiga, or both:
  1565.   
  1566.                     0 = No signal (default) 
  1567.                     1 = Beep 
  1568.                     2 = Flash 
  1569.                     3 = Beep   Flash
  1570.  
  1571.  
  1572.                   PanaColor <Num> (default: 0) 
  1573.  
  1574. PanaColor  defines the default text printing colour:
  1575.  
  1576.                     0 =  Black (default) 
  1577.                     1 =  Magenta 
  1578.                     2 =  Cyan 
  1579.                     3 =  Blue 
  1580.                     4 =  Yellow 
  1581.                     5 =  Red 
  1582.                     6 =  Green
  1583.  
  1584. PanaGDit: <X> <Y>  <a11, a12,... etc.> (default: Halftone A 64)
  1585. PanaCDit: <X> <Y>  <a11, a12,... etc.> (default: Halftone A 64)
  1586. PanaMDit: <X> <Y>  <a11, a12,... etc.> (default: Halftone A 64)
  1587. PanaYDit: <X> <Y>  <a11, a12,... etc.> (default: Halftone A 64)
  1588. PanaKDit: <X> <Y>  <a11, a12,... etc.> (default: Halftone A 64)
  1589.  
  1590. These variables allow you to define the required dither matrix for
  1591. each primary print colour (G=grey, C=cyan, M=magenta, Y=yellow and
  1592. K=black).   Several dither matrices are included with PanaPlus
  1593. (Ordered,  Halftone,  Spiral,  Line,  etc.).   These  matrices are
  1594. stored in a directory named ` dither-settings ' which can be found
  1595. in  your  ` Dither-Settings ' drawer.  You may copy these matrices
  1596. directly  to  env:   ,  or  define a matrix of your own.
  1597.  
  1598.                PanaFast   0|1  (default: 0) 
  1599.  
  1600. If  set to 1, the driver sends out graphics faster to the printer.
  1601. While  the  printing speed can be improved significantly, printing
  1602. quality   may   be  loosed  and  vertical  lines  may  be  printed
  1603. misaligned.
  1604.  
  1605.  
  1606.                PanaForm   ON|OFF  (default: OFF) 
  1607.  
  1608. If  PanaForm  is  ON  ,  page  length  (as  set  in  Workbench
  1609. preferences)  and  Perforation Skip will be enabled by the driver.
  1610. In order to stay compatible with normal Workbench printer drivers,
  1611. by default the settings are not used.  Some applications require a
  1612. well-defined  paper  size  and  margins  for  printing forms.  The
  1613. Panasonic  driver  provides  you  with  these facilities by setting
  1614. PanaForm  to  ON  .   It may require some experimentation (and
  1615. paper)   until   you  find  the  correct  values  for  a  specific
  1616. application.
  1617.  
  1618.               PanaGFeed    <Num>  (default: 0) 
  1619.  
  1620. Most  printers have problems with their internal mechanics causing
  1621. unwanted  horizontal  stripes  in  the  graphic output.  Often the
  1622. linefeed  is  a  bit too much or too little, causing dark or white
  1623. horizontal    lines.     This   problem   is   called   `banding'.
  1624. PanaGFeed  allows  you  to adjust the driver to the mechanical
  1625. inaccuracy  of  the  printer.   Set PanaGFeed to 1 if you have
  1626. white lines in the output, or 2 if you have dark lines:
  1627.  
  1628.                      0 = Normal linefeed 
  1629.                      1 = Decrease linefeed 
  1630.                      2 = Increase linefeed
  1631.  
  1632.  
  1633.             PanaMagenta: <Num>  (default: 0%) 
  1634.  
  1635. Printer  ribbon  inks  are  not  completely  pure  materials.  For
  1636. example  there is some yellow mixed into the magenta ink, and some
  1637. magenta in the cyan ink.  The ink compensation values will correct
  1638. for  these  impurities.  With magenta compensation you specify the
  1639. percentage of magenta in the cyan ink.
  1640.  
  1641. The  ink  compensation  function  can  be  completely  disabled by
  1642. specifying  0 .  You will notice that without the ink compensation
  1643. function   a  blue  sky  will  print  as  purple.   With  the  ink
  1644. compensation  function set to 10--30 , blue skies are usually blue
  1645. again.
  1646.  
  1647. PanaMagenta defines the percentage of magenta in the cyan ink,
  1648. and may range from 0 to 100%.
  1649.  
  1650.  
  1651.                 PanaMirror:   ON|OFF  (default: OFF) 
  1652.  
  1653. If  set  to  ON , graphics will be mirrored.  Especially useful if
  1654. you want to print pictures intended for T-shirt art.
  1655.  
  1656.  
  1657.                 PanaPerf: <Num>  (default: 0 lines) 
  1658.  
  1659. If  PanaForm  is set to ON, PanaPerf specifies the number
  1660. of  lines  that  the  printer skips at the end of each page.  This
  1661. causes  the  printer  to  skip  the  perforation  between pages of
  1662. continuous  forms.   If zero lines are specified, perforation skip
  1663. will  be disabled.  If the specified PanaPerf value is greater
  1664. than  or  equal  to  the  form length (as defined in the Workbench
  1665. preferences  program),  the  skip perforation is cancelled and the
  1666. top and bottom margins become inactive.
  1667.  
  1668.                 PanaResX: <Num>   (default: 0 dots)
  1669.  
  1670. If  the  preferences paper size is CUSTOM , this option allows you
  1671. to  specify  the  horizontal resolution (width) for graphic dumps.
  1672. The  size  is specified in 360 dpi dots.  If you specify zero (the
  1673. default)  as the resolution, the US LETTER resolution of 2880 dots
  1674. will  be  used.   The  allowed range for <Num> is 0 to 65535 dots.
  1675. The  PanaResX  setting  is  used  by  the  driver for graphics
  1676. printing only.
  1677.  
  1678.                PanaResY: <Num>   (default: 0 dots) 
  1679.  
  1680. If the preferences paper size is CUSTOM, this option allows you to
  1681. specify  the  vertical resolution (height) for graphic dumps.  The
  1682. size  is  defined  as  360  dpi  dots.   If  you specify zero (the
  1683. default) as the resolution, the US LETTER resolution will be used.
  1684. The  allowed range for <Num> is 0 to 65535 dots.  The PanaResY
  1685. setting is used by the driver for graphics printing only.
  1686.  
  1687.               PanaSep:  C M Y K   (default: CMYK) 
  1688.  
  1689. With  this  option  you  can  print  a  CYMK colour component of a
  1690. picture.   For example, if you want to print the cyan component of
  1691. a  picture  set  PanaSep  to C .  The combination of following
  1692. characters, in any order, is allowed:
  1693.  
  1694.                      C = Cyan 
  1695.                      M = Magenta 
  1696.                      Y = Yellow 
  1697.                      K = Black 
  1698.  
  1699.  
  1700.              PanaSuper:   ON|OFF  (default: OFF) 
  1701.  
  1702. Normal Workbench printer drivers are limited to 16 shades of grey.
  1703. After  brightening  the  graphic  output,  even  fewer  shades are
  1704. available.   PanaPlus  does  not  have this limitation and can
  1705. print colour pictures in up to 256 shades of grey.
  1706.  
  1707. With  PanaSuper  enabled, every colour picture will be printed
  1708. as  a  greyscale picture if you select colour instead of greyscale
  1709. as  the  graphics  output  mode.  With Supergrey it is the printer
  1710. driver's  task  to  convert  the  colour data into greyscale data.
  1711. While  this  can  be  done  by  the  printer device instead of the
  1712. printer  driver (as normal Workbench drivers do), the PanaPlus
  1713. printer  driver  colour-to-greyscale  conversion routines are more
  1714. precise.   Because of this you can print a 4096 colour HAM picture
  1715. in  up  to 256 shades of grey instead of the normal 16.  Supergrey
  1716. will replace the normal colour dump of the driver.
  1717.  
  1718. The  Table  below  shows  all  parameters that must be enabled for
  1719. printing with Supergrey.
  1720.  
  1721.   Function              Density   Workbench dither     
  1722.  
  1723. Supergrey                 >2          ordered 
  1724. Colour Adjustment         >2          ordered 
  1725. Ink compensation          >2          ordered 
  1726. Driver dithers            >2          ordered 
  1727.  
  1728. Note:   the  number  of  printable  shades  of  greys in Supergrey
  1729. depends on the number of shades supported by the dither method set
  1730. in  PanaPref.  Up to 256 shades are possible, and supported by
  1731. the  PanaPlus  dither  routines.   Often  a dither method that
  1732. produces 64 shades (default) gives best results.
  1733.  
  1734.  
  1735.  
  1736.                PanaTab:  <Num>  (default: 9, 17, 25,...) 
  1737.  
  1738. This  environment  variable allows you to customize the horizontal
  1739. tab  stops  settings  of  your  printer.   This  may be useful for
  1740. printing  program  listings and tables.  Up to 32 tab stops may be
  1741. defined.
  1742.  
  1743.                 PanaTime: <Num>  (default: 60 seconds) 
  1744.  
  1745. If  huge amounts of data are being transferred to the printer, the
  1746. actual printing of the image happens much faster than the transfer
  1747. of  the  data.   A  requester  may  appear  on the screen saying `
  1748. Printer  trouble...   '.   This appears because the printer device
  1749. thinks  no data has been transferred due to a hardware or software
  1750. failure.   With  PanaTime you can specify the time that should
  1751. pass before the printer device puts up the error requester.
  1752.  
  1753. With  Timeout you can specify a higher timeout value, resulting in
  1754. fewer  timeout  requesters.   A  value  from  1  to 999 seconds is
  1755. allowed (default 60 seconds).
  1756.  
  1757. Instead of defining a huge timeout value there is another solution
  1758. available:   use  the  CMD  program  (see  your Workbench disk) to
  1759. redirect  the  parallel/serial  output  to  a file on disk.  After
  1760. this,  use  the Copy command or a printer spooler to copy the file
  1761. to par:  .
  1762.  
  1763. Note:  if a real error occurs, you will have to wait the number of
  1764. seconds   specified  by  PanaTime  until  an  error  requester
  1765. appears,  thus  allowing  you  to cancel the print job.  So choose
  1766. your PanaTime value wisely.
  1767.  
  1768.                 PanaType: <Num>   (default: 0) 
  1769.  
  1770. Specifies the typeface to be selected on aRIS, aRIN and aFNT0.  If
  1771. you  select  zero  (the  default),  the  typeface  selected on the
  1772. printer control panel will be used.  PanaType may range from 0
  1773. to 255.  See your printer manual for the values used for selecting
  1774. a required typeface on your printer, and add 1 to the value.
  1775.  
  1776.                PanaYellow:  <Num>  (default: 0%) 
  1777.  
  1778. Printer  ribbon  inks  are  not  completely  pure  materials.  For
  1779. example  there is some yellow mixed into the magenta ink, and some
  1780. magenta in the cyan ink.  The ink compensation values will correct
  1781. for  these  impurities.  With magenta compensation you specify the
  1782. percentage of magenta in the cyan ink.
  1783.  
  1784. The  ink  compensation  function  can  be  completely  disabled by
  1785. specifying  0%.  You will notice that without the ink compensation
  1786. function   a  blue  sky  will  print  as  purple.   With  the  ink
  1787. compensation  function set to 10-30%, blue skies are usually blue
  1788. again.
  1789.  
  1790. PanaYellow defines the percentage of yellow in the magenta ink
  1791. and may range from 0 to 100%.
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.                               Glossary 
  1806.                               ========
  1807.  
  1808.  
  1809.  
  1810.  
  1811.                               Default
  1812.  
  1813. A value used in place of a user-selected value.  A factory default
  1814. is  a  value programmed into the device at the factory; this value
  1815. is  stored  in  read-only  memory (ROM) and cannot be changed by a
  1816. user  or operator.  A user default is a default that is selectable
  1817. via the control panel.
  1818.  
  1819.                                 Dot
  1820.  
  1821. A  dot  is  the smallest thing a printer can print.  The number of
  1822. dots  printed  per inch is referred to as the printer's resolution
  1823. (dpi).
  1824.  
  1825.                               Download
  1826.  
  1827. The process of transferring soft fonts, macros or raster data from
  1828. a   host   computer   to  the  printer's  user  memory  is  called
  1829. downloading.
  1830.  
  1831.                                 DPI 
  1832. See Dot.
  1833.  
  1834.                             ENV:   ENVARC:
  1835.  
  1836. The  Amiga  operating  system  and  the PanaPlus driver stores
  1837. their  environment  settings in two special directories named ENV:
  1838. and ENVARC:.  Settings saved in ENV:  are only for temporary usage
  1839. and get lost when turning the computer off.
  1840.  
  1841.                              Parallel I/O
  1842.  
  1843. An  input/output  interface  that  transmits  more than one bit of
  1844. information   simultaneously.    Centronics  is  an  industry-wide
  1845. standard form of a parallel interface.
  1846.  
  1847.                                Pitch 
  1848.  
  1849. Pitch  describes  the number of characters printed in a horizontal
  1850. inch.   Pitch  only applies to fixed-spaced fonts since the number
  1851. of  characters  per  inch  varies for proportionally-spaced fonts.
  1852. See Spacing.
  1853.  
  1854.                             Printable Area
  1855.  
  1856. The  printable  area is the area of the physical page on which the
  1857. printer is able to place a dot, wheras the physical page refers to
  1858. the actual size of the paper installed in the printer.
  1859.  
  1860.                            Raster Graphics 
  1861.  
  1862. Images composed of groups of dots are called raster images.
  1863.  
  1864.                                Spacing 
  1865.  
  1866. Fonts  have  either  fixed  or proportional spacing.  Fixed-spaced
  1867. fonts are those for which the inter-character spacing is constant.
  1868. Proportionally-spaced    fonts    are    those   for   which   the
  1869. inter-character  spacing  varies  with  the  natural  shape  of  a
  1870. character.
  1871.  
  1872.                               Typeface 
  1873.  
  1874. Typeface  is  a  generic  name  for graphics symbols having common
  1875. design  features.   Each  typeface  has  unique and distinguishing
  1876. characteristics.
  1877.